---
title: Migrando desde Docusaurus
description: Consejos para migrar un proyecto existente de Docusaurus a Astro
type: migration
stub: true
framework: Docusaurus
i18nReady: true
---

import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'

[Docusaurus](https://Docusaurus.io) es un popular constructor de sitios web de documentación construido con React.

## Principales similitudes entre Docusaurus y Astro

Docusaurus y Astro comparten algunas similitudes que te ayudarán a migrar tu proyecto:

- Astro y Docusaurus son constructores de sitios web modernos basados en JavaScript (Jamstack), [orientadas al contenido](/es/concepts/why-astro/#orientado-al-contenido), como sitios de documentación. 

- Astro y Docusaurus admiten [páginas MDX](/es/guides/markdown-content/). Deberías poder utilizar tus archivos `.mdx` existentes en Astro.

- Astro y Docusaurus usan el [enrutamiento basado en archivos](/es/guides/routing/) para generar rutas de de página automáticamente para cualquier archivo MDX ubicado en `src/pages`. El uso de la estructura de archivos de Astro para tu contenido existente y al agregar nuevas páginas debería ser familiar.

- Astro tiene una [integración oficial para usar componentes de React](/es/guides/integrations-guide/react/). Ten en cuenta que en Astro, los archivos de React **deben** tener la extensión `.jsx` o `.tsx`.

- Astro admite la [instalación de paquetes de NPM](/es/guides/imports/#paquetes-npm), incluyendo varios para React. Podrás conservar algunos o todos tus componentes y dependencias existentes de React.

- [La sintaxis similar a JSX de Astro](/es/basics/astro-components/#maquetado-del-componente) debería resultarte familiar si estás acostumbrado a escribir en React.


## Principales diferencias entre Docusaurus y Astro

Cuando reconstruyas tu sitio de Docusaurus a Astro, notarás algunas diferencias importantes:

- Docusaurus es una aplicación de una sola página (SPA) construida en React. Los sitios de Astro son aplicaciones de varias páginas construidas utilizando [componentes `.astro`](/es/basics/astro-components/), pero también puede admitir [React, Preact, Vue.js, Svelte, SolidJS, AlpineJS, Lit](/es/guides/framework-components/) y plantillas de HTML sin procesar.

- Docusaurus fue diseñado para construir sitios web de documentación y tiene algunas características integradas, específicas para sitios web de documentación que tendrás que construir por ti mismo en Astro. En cambio, Astro ofrece algunas de estas características a través de un [Starlight: un tema oficial de documentación](https://starlight.astro.build). ¡Este sitio web fue la inspiración para Starlight y ahora se ejecuta en el ! También puedes encontrar más [temas de documentación de la comunidad](https://astro.build/themes?search=&categories%5B%5D=docs) con características integradas en nuestro mostrador de temas.

- Los sitios de Docusaurus utilizan páginas MDX para el contenido. El tema de documentación de Astro utiliza archivos Markdown (`.md`) por defecto y no requiere que utilices MDX. Opcionalmente puedes [instalar la integración de MDX de Astro](/es/guides/integrations-guide/mdx/) (incluida en nuestro tema de Starlight por defecto) y usar archivos `.mdx` además de los archivos de Markdown estándar.


## Migrar de Docusaurus a Astro

Para convertir un sitio de documentación de Docusaurus a Astro, empieza con nuestra [plantilla oficial de inicio para documentación Starlight](https://starlight.astro.build), o explora más temas de la comunidad en nuestro [catálogo de temas](https://astro.build/themes?search=&categories%5B%5D=docs). 

Puedes pasar el argumento `--template` al comando `create astro`  para empezar un nuevo proyecto de Astro con una de nuestras plantillas oficiales. O, puedes [comenzar un nuevo proyecto desde cualquier repositorio de Astro existente en GitHub](/es/install/auto/#plantillas-de-inicio).

  <PackageManagerTabs>
    <Fragment slot="npm">
    ```shell
    npm create astro@latest -- --template starlight
    ```
    </Fragment>
    <Fragment slot="pnpm">
    ```shell
    pnpm create astro@latest --template starlight
    ```
    </Fragment>
    <Fragment slot="yarn">
    ```shell
    yarn create astro --template starlight
    ```
    </Fragment>
  </PackageManagerTabs>


La integración de MDX de Astro está incluida por defecto, por lo que puedes [traer tus archivos de contenido existentes a Starlight](https://starlight.astro.build/es/getting-started/#add-content) de inmediato.

Puedes encontrar la plantilla inicial de documentación de Astro, y otras plantillas oficiales, en [astro.new](https://astro.new). Encontrarás un enlace al repositorio de GitHub de cada proyecto, así como enlaces de un solo clic para abrir un proyecto de trabajo en los entornos de desarrollo en línea de StackBlitz, CodeSandbox y Gitpod.

## Recursos de la comunidad

- ¡Añade el tuyo propio!
